.TH LCTL-NODEMAP_ADD_RANGE 8 2024-08-14" Lustre "Lustre Configuration Utilities"
.SH NAME
lctl-nodemap_add_range \- define a range of NIDs for a nodemap
.SH SYNOPSIS
.SY "lctl nodemap_add_range"
or
.SY "lctl nodemap add_range"
.BI --name " NODEMAP_NAME"
.BI --range " NID_RANGE"
.YS
.SH DESCRIPTION
.B nodemap_add_range
adds a range of NIDs to an existing nodemap.
The NID range cannot overlap with an existing NID range except with a dynamic
overlay range.
Clients with NIDs that fall into the new range
will be moved into the given nodemap and any future RPCs will be subject
to the properties configured for that nodemap.
.SH OPTIONS
.TP
.BI --name " NODEMAP_NAME"
The name of the nodemap that this range should be added to.
.TP
.BI --range " NID_RANGE"
The NID range that should be added to the nodemap.
The syntax for the range is the same as the rootsquash syntax,
with the added constraint that the range must be contiguous.
.SH Formal LNet NID Range Definition
.EX
NID_RANGE    :== ADDR_RANGE@NET
ADDR_RANGE   :== '*' | NETMASK | IPV6_ADDR | IPADDR_RANGE | NUM_RANGE
IPADDR_RANGE :== NUM_RANGE.NUM_RANGE.NUM_RANGE.NUM_RANGE
NUM_RANGE    :== NUMBER | EXPR_LIST
EXPR_LIST    :== '['RANGE_EXPR[,RANGE_EXPR]']'
RANGE_EXPR   :== NUMBER | MIN-MAX | MIN-MAX/SKIP
NET          :== NET_TYPE[NUMBER]
.\" Currently supported LNet types are listed in libcfs_netstrfns[]
NET_TYPE     :== "lo" | "tcp" | "o2ib" | "ptlf" | "gni" | "gip" | "kfi"
NUMBER       :== NONNEGATIVE_DECIMAL | HEXADECIMAL
.EE
Where
.IR NETMASK
is an IPv4 or IPv6 network mask in CIDR notation,
.IR IPV6_ADDR
is a single IPv6 address,
.IR MIN - MAX / SKIP
indicates a sequence of numbers starting at
.I MIN
and incrementing by
.I SKIP
each time until no larger than
.IR MAX ,
and
.IR MIN - MAX
is equivalent to
.IR MIN - MAX / 1 .
.SH EXAMPLES
.EX
.B # lctl nodemap_add_range --name remotesite --range 192.168.1.[1-254]@tcp
.B # lctl nodemap_add_range --name othersite --range 192.168.2.[1-254]@tcp
.EE
.SH AVAILABILITY
.B lctl nodemap_add_range
is part of the
.BR lustre (7)
filesystem package since release 2.6.0
.\" Added in commit v2_5_56_0-13-g4642f30970
.SH SEE ALSO
.BR lustre (7),
.BR lctl-nodemap-activate (8),
.BR lctl-nodemap-add (8),
.BR lctl-nodemap-add-idmap (8),
.BR lctl-nodemap-del (8),
.BR lctl-nodemap-del-idmap (8),
.BR lctl-nodemap-del-range (8),
.BR lctl-nodemap-modify (8)
